home *** CD-ROM | disk | FTP | other *** search
/ World of Video / World of Video.iso / gfxprograms / misc / maptrix / maptrix.doc < prev    next >
Text File  |  1995-02-13  |  9KB  |  269 lines
  1.  
  2. =====================================================================
  3. INTRODUCTION
  4.  
  5.  
  6. What is MapTrix?
  7. ----------------
  8.  
  9. MapTrix is a texture map/backdrop generator. It offers a number
  10. algorithms to generate fractals and randomly generated images which
  11. are ideal for image mapping, backdrops or interesting visual displays.
  12.  
  13. MapTrix is shareware. This demo version has limited bitmap sizes and
  14. will not generate animation frames. See the included file MUST_READ
  15. for more information.
  16.  
  17.  
  18. Installation
  19. ------------
  20.  
  21. o   MapTrix __REQUIRES AMIGA DOS 2.04__ or higher
  22.  
  23. o   2 megs of ram recommended
  24. o   Hard drive recommended
  25.  
  26.  
  27. On A Hard Drive
  28. ---------------
  29.  
  30. Create a directory on your hard disk labelled 'MapTrix'. Copy the
  31. main program, along with the icon, to this directory. Also copy the
  32. included directory 'Data' and all files within it to this directory.
  33. Finally, add the following to your user-startup file:
  34.  
  35.     assign MapTrix: hard_drive:directory/maptrix
  36.  
  37. 'hard_drive:' should be the label of your hard disk, ie. 'work:'.
  38. 'directory' should be the complete directory path to where you put
  39. the 'MapTrix' directory.
  40.  
  41.  
  42. On A Floppy System
  43. ------------------
  44.  
  45. Format a blank disk labelled 'MapTrix:'. Copy the main program and
  46. its icon to this disk. Also copy the 'Data' directory and all files
  47. within it to this disk.
  48.  
  49.  
  50. =====================================================================
  51. USING THE SOFTWARE
  52.  
  53.  
  54. Quick Start
  55. -----------
  56.  
  57. Run the program MapTrix from the shell or the Workbench. Press the
  58. button labelled 'GENERATE' at the bottom center of the screen. You will
  59. see a yellow progress bar drawn across the bottom of the screen. Once
  60. the line above the yellow bar reads 'Operation Successful' press the
  61. 'DISPLAY' button. Once you are done viewing the picture click the left
  62. mouse button on the displayed image, or press the 'Esc' key.
  63.  
  64.  
  65. The User Interface
  66. ------------------
  67.  
  68. MapTrix is designed around a screen which contains four sub-sections.
  69. In clockwise order from top-left: the `Function List', the `Function
  70. Panel', the `Control Panel' and the `Info Panel'.
  71.  
  72. To operate the software, choose the desired operation from the
  73. `Function List'. You can scroll the list up and down and then click on
  74. the desired operation. 
  75.  
  76. Then, adjust the parameters in the Function Panel. Different
  77. functions have different parameters. To start, you may want to stick
  78. with the default parameters for each function.
  79.  
  80. Start the function with the Control Panel 'GENERATE' button. You can
  81. at any time press the 'ABORT!' button in the bottom right corner to
  82. terminate the operation.
  83.  
  84. Finally you can view the results with the 'DISPLAY' button in the 
  85. `Info Panel', located at the lower left. While rendering you can use
  86. the number keys 1-9 and the space bar to get different palettes.
  87.  
  88. Once you have a desireable image, save it with the pull-down menu
  89. option "Save IFF".
  90.  
  91.  
  92. The Function List
  93. -----------------
  94.  
  95. This list is all the possible operations MapTrix can perform at this
  96. time. There are groups of functions including midpoint displacement
  97. algorithms, sine wave synthesis, random generators, some image
  98. processing tools and display capabilites. 
  99.  
  100.  
  101. The Function Panel
  102. ------------------
  103.  
  104. Each function has a certain number of parameters which control how
  105. the image will be produced. Some operations have very few parameters,
  106. such as Mountains, while others have many, such as Harmony 2.
  107.  
  108.  
  109. The Control Panel
  110. -----------------
  111.  
  112. Here is where you start and stop the current function. A progress
  113. indicator lets you know how far along the operation is. Some
  114. operations need more than one pass to complete. For example, most of
  115. the 'Process' functions require one pass to "quantize" the bitmap,
  116. and another pass to actually do the operation.
  117.  
  118.  
  119. The Info Panel
  120. --------------
  121.  
  122. This panel tells you how large the image is, gives your system memory
  123. details, and lets you Render the image, change it's size and Undo the
  124. last operation (useful for the image processing tools).
  125.  
  126.  
  127. The Menu
  128. --------
  129.  
  130. The menu is fairly simple. Options let you load and save images,
  131. adjust image parameters, and examine the generation time of the
  132. last function.
  133.  
  134.  
  135.  
  136. =====================================================================
  137. FINER POINTS
  138.  
  139.  
  140. If you have features you'd like to see in MapTrix, then please pass
  141. them along. I'm more than willing to place new features in the
  142. software per user request.
  143.  
  144.  
  145. Display Modes:
  146. --------------
  147.  
  148. MapTrix can handle large bitmaps, up to 8 bitplanes deep. It cannot
  149. display AGA images at this time, but this is on the top of the list
  150. of features to add.
  151.  
  152. For an interesting display of color, press the TAB key while
  153. displaying an image. The color cycling can be reversed by pressing
  154. Shift-TAB. The position of the mouse pointer will affect the speed of
  155. the cycling. Move the mouse to the right to slow it down, and to the
  156. left to speed it up.
  157.  
  158. Also, pressing the space bar while viewing the image will fractalize
  159. the palette. Likewise, pressing Shift-space will recreate the last
  160. fractal palette.
  161.  
  162. You can get out of the display mode by pressing the 'ESC' key (or any
  163. un-recognized key), clicking on the display screen, or pressing the
  164. 'Abort' button on the 'Control Panel'.
  165.  
  166. You may also want to try the DEL and HELP keys. The DEL key will
  167. rotate the red green and blue values for each color, while the HELP
  168. key will XOR the palette, resulting in a complimentary color palette.
  169.  
  170.  
  171. The Functions:
  172. --------------
  173.  
  174. Mountains:      Creates a midpoint displaced fractal image. The Grid
  175.                 size determines how many points will be used to
  176.                 produce the image. The more the better.
  177.                 The Slice option determines how many times to 
  178.                 subdivide the grid after it has been generated. This
  179.                 will give rise to "rivers" in the mountains.
  180.  
  181. Clouds:         A different implimentation of the midpoint
  182.                 displacement algorithm. This uses the screen for
  183.                 storage, and has an associated "grain" setting to
  184.                 increase the "clumpiness" of the finished image.
  185.  
  186. Harmony 2       This function will create and add together cosine
  187.                 waves. There are a number of options (9 total), each
  188.                 altering the final image. You can also adjust the
  189.                 frequency of each wave with the 'Freq' paramters.
  190.  
  191. Harmony Marble  This is a different kind of cosine function which
  192.                 adds and scales successive waves together.
  193.  
  194. Radiate         Has two options, Circular and Random. The Circular
  195.                 option will generate "count" number of rippling waves
  196.                 which interfere with one another. The Random option
  197.                 uses the same technique but uses a random curve, or
  198.                 Brownian curve, to the same effect.
  199.  
  200. Waves           This function has a number of options which generate
  201.                 horizontal and vertical waves which interact in
  202.                 different ways.
  203.  
  204. Waterfall       This is a random function which can "bleed" from the
  205.                 top to the bottom. The diffusion setting determines
  206.                 how fast the color will approach "entropy".
  207.  
  208.  
  209.  
  210.  
  211. =====================================================================
  212. FINER POINTS
  213.  
  214.  
  215. Weave           Generates a 2 way interactive brownian curve.
  216.  
  217. Streaks         Maps brownian curves in different directions.
  218.  
  219. Static          A simple static generator. Has a statistical
  220.                 "capping" flag called 'Tame' which ensures the colors
  221.                 never get too far beyond the middle color.
  222.  
  223. Display         This is the normal display mode. Set the 'Scale' to
  224.                 "NONE" to allow fractal palettes, or choose one of the
  225.                 built in scaled palettes. You can also choose whether
  226.                 you want color cycling to "grow" over time, or loop in
  227.                 the normal manner.
  228.  
  229. Display DCTV    You will need dctv.library and a DCTV display device to
  230.                 use this feature. Options let you choose a random or
  231.                 scaled palette, and you also have the option of
  232.                 positioning the DCTV screen. The default values work
  233.                 great on the system I tried this on. If you get strange
  234.                 blinking or a "shimmering" effect then adjust these
  235.                 values to correct the problem.
  236.  
  237. Mandelbrot      A basic Mandelbrot Fractal generator. Allows zoom and
  238.                 has an aspect ratio correction feature.
  239.  
  240. Julia           A basic Julia Curve generator. Also allows zoom and
  241.                 aspect ratio correction.
  242.  
  243. Convolve 3x3    A fast convolve matrix. This and the following
  244.                 functions add great possibilites to all functions.
  245.  
  246. Convolve 5x5    A fast convolve matrix.
  247.  
  248. Ruffian         Allows displaced or color based changes to an image.
  249.                 Each pixel is affected in some way, either by color
  250.                 or by exchanging it with a neighboring pixel.
  251.  
  252. Emboss          Embosses the image.
  253.  
  254. Resize          Allows resizing of the image.
  255.  
  256.  
  257. =====================================================================
  258. WRAP UP
  259.  
  260.  
  261. Well, this should be anough to give you a general idea of how
  262. MapTrix operates, and what it can do in it's current state. As the
  263. need arises, I will probably be adding new features, and hopefully,
  264. the ability to display in some more advanced modes.
  265.  
  266.  
  267. -- Alex Deburie
  268.  
  269.